home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 435_01 / readme.txt < prev    next >
Encoding:
Text File  |  1994-08-10  |  5.1 KB  |  100 lines
  1. VesaTest
  2. --------
  3.  
  4.    This is a demonstration of how to utilize the 640x480x256 color SVGA mode
  5. by means of VESA device driver calls.  Not only that, but included is several
  6. routines which show off video cards which use more than 1 meg of ram through
  7. virtual paging.
  8.    Included and integrated into the demo package are routines to handle full
  9. digitized sound support (.wav or .voc type files) with double-buffering and
  10. full DMA/IRQ detection!  No more asking the user for information.
  11.    Also in this package are mouse routines which intercept mouse interrupts
  12. and full support for 2-button and 3-button mice.  2-button users can simulate
  13. the middle button by pressing left and right buttons simultaneously, so there's
  14. no real disadvantage in programming for 3 buttons.
  15.  
  16. The source code was written in Borland C++ v3.1.  This package is released
  17. to the public as of July 20th, 1994 as Tagware.  If you find it useful and
  18. you write something using any of the routines in my package, please put a tag
  19. in your program's title screen (or someplace visible) that I helped you.
  20. Try to send me a copy of it too.  I like to see new software (w/ my name on 
  21. it, of course :-).
  22.  
  23. Caution: Many SVGA card manufacturers did not and continue to not provide good
  24. device drivers for their VESA compatibility modes.  My first recommendation is
  25. to try whatever the manufacturer gives out with the card.  If this package
  26. fails for whatever reason, attempt to obtain the most recent version of the
  27. Universal VESA Bios Extender (UniVBE) from any good FTP site.  I believe as
  28. of this writing, "univbe43.zip" was still floating around and version 5.0 was
  29. due out.  UniVBE is a very stable, fast driver for almost any card.  If you
  30. are to rely on VESA calls, you must recognize that out of every 10 SVGA cards
  31. out there, you can count on at least two of them being very incompatible.
  32.  
  33. This archive contains:
  34.     WAVCOMP.EXE         An ADPCM .wav compressor.  Not compatible with anything
  35.     WAVUNCOM.EXE        The matching decompressor for WAVCOMP.EXE
  36.     VESATEST.EXE        Compiled demo program
  37.     VESANOIZ.SPA        Compressed .wav file
  38.     VESATEST.CPP        Source code to demo
  39.     RUNME.BAT           Last minute note to users and decompresses VESANOIZ.SPA
  40.     README.TXT          See README.TXT...
  41.  
  42. If you are missing any files, please contact the sysadmin at the site from
  43. which you received this archive and alert them of the mistake.
  44.  
  45. To send donations, I prefer a postcard from your city, state, or country.  If
  46. you insist on monetary donations, $5 is certainly sufficient--but don't let
  47. me stop you from sending more.  Realize that I cannot afford to send anything
  48. back, so please don't send disks, pictures, tapes, cats, loved ones, or other
  49. personal affects which might be important to you, because I'll keep them.
  50. That's not a promise, though, so no ex-wives or ex-husbands. :-)  I'll send
  51. them back.
  52.  
  53. Ground mail (USA):  Jason Hughes      Email: hughes@ccwf.cc.utexas.edu
  54.                     5812 Abilene Trail
  55.                     Austin, TX 78749
  56.  
  57. Thanks go out to the Game Programmer's Encyclopedia, Game Developer's Magazine,
  58. everybody at rec.games.programmer, comp.os.msdos,programmer, VLA (palettes),
  59. and innumerable others who voluntarily tested this over the past three months.
  60.                 G      R     A     C    I    A    S    !
  61.  
  62. ...one last thing, if you send me any (e)mail, please tell me how and where
  63. you found VESATEST.  I'm especially interested in hearing about compilations
  64. and CDROMs and so forth.  
  65.  
  66. Enjoy!
  67.  
  68. The Panther!
  69.  
  70. ------------------------------------------------------------------------------
  71. This appendage is to tell users that this is revision 2 of the demo/library.
  72.  
  73. Changes include:
  74.   o  3-button mouse detection
  75.   o  a global variable called "mousebuttons" which contains either 2 or 3,
  76.        depending on what kind of mouse is detected
  77.   o  double speed mouse movement at a program- or user- specified breakover
  78.        point, so if you move slow it's high resolution, fast it's twice as fast
  79.   o  simulation of a third button with 2-button mice (is simple to comment out)
  80.   o  fixed bug where vesa initialization would return errors on black screen
  81.        with black characters (smack! "Stuupid, soo stuupid!")
  82.   o  clearscr() now clears all the ram in the video card, not only first meg
  83.  
  84. Special notes:
  85.   If you are using a 3-button mouse, it may be possible that the button states
  86. are inverted.  Please send me a note in email along with a description of your
  87. mouse and driver and com port information.  The data I received on button 
  88. states (0 being pressed, 1 being released) was backwards for _my_ mouse, no
  89. matter what drivers I tested with it, so I naturally made it work properly for
  90. _my_ mouse.  I hope I did the right thing.  <crosses fingers>
  91.  
  92. Any comments, complaints, or ideas are welcome.  But please try to do minimal
  93. troubleshooting with your system and vesa card configuration before telling
  94. me this stuff doesn't work.  It does.  Merely realize that SVGA is extremely
  95. nonstandard and sometimes it cannot be helped that things do not work as 
  96. planned.  Thank you for your consideration.
  97.  
  98. The Panther!
  99. hughes@ccwf.cc.utexas.edu
  100.